home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir31 / cdplay34.zip / MANUAL.DOS < prev    next >
Text File  |  1993-08-29  |  40KB  |  911 lines

  1. CDPlayer from Jupiter Software                                         Page 1
  2.  
  3.  
  4.  
  5. CDPLAYER
  6. FROM JUPITER SOFTWARE
  7.  
  8. The information in this manual is subject to change without notice and does
  9. not represent a commitment on the part of Jupiter Software.  The software may
  10. be used or copied only in accordance with the terms of the licence agreement.
  11.  
  12. All rights reserved.  This manual contains proprietary information which is
  13. protected by copyright.  No part of this manual may be reproduced, transcribed,
  14. stored in a retrieval system, translated into any language in any form
  15. whatsoever without the prior written consent of the publisher.
  16.  
  17. Jupiter retains title to and ownership of the programs.  You are licensed to
  18. use the programs for a trial period of 30 days.  After this period you must
  19. either register as a user or remove the programs from your system.  See
  20. ORDER.FRM for details of how to register.
  21.  
  22. Please read the Licence agreement contained in a separate file.
  23.  
  24.  
  25. For further information or support contact -
  26.  
  27. Jupiter Software
  28. 63 Parkside
  29. Wimbledon
  30. London
  31. SW19 5NL
  32. England
  33.  
  34. Tel No. (+44) 081-946 4826
  35. Fax No. (+44) 081-879 0090
  36.  
  37. EMail - CompuServe: 100140,2134
  38.      or pbrace@cix.compulink.co.uk
  39.  
  40. Jupiter Software is a member of the Association of Shareware Professionals
  41. (ASP)
  42.  
  43. Copyright (c) 1993 Jupiter Software
  44.  
  45. CDPlayer from Jupiter Software                                         Page 2
  46.  
  47.  
  48.                                     CONTENTS
  49.  
  50.                                                                  Page
  51.  
  52.           A    INTRODUCTION                                       3
  53.  
  54.           B    BASIC OPERATIONS
  55.  
  56.                1    Run CDPlayer
  57.                         Command line option                       4
  58.  
  59.                2    The CD Handset                                4
  60.  
  61.                3    Display area                                  5
  62.  
  63.                4    Function Keys                                 5
  64.  
  65.           C    DISC CATALOGUE                                     8
  66.  
  67.                1    Entering/editing the record for the
  68.                                current disc                       8
  69.  
  70.                2    Browsing through your catalogue               9
  71.  
  72.                3    Editing during browsing                       11
  73.  
  74.           D    INSTALLATION                                       12
  75.  
  76.  
  77. CDPlayer from Jupiter Software                                         Page 3
  78.  
  79. A    INTRODUCTION
  80.  
  81. CDPlayer(TM) is a DOS audio CD playing program which provides all the
  82. functions associated with a normal CD player, together with the ability to
  83. catalogue and search your CD collection.
  84.  
  85. Features include:
  86.  
  87.      Custom programme play
  88.  
  89.      Single track play
  90.  
  91.      Shuffle play
  92.  
  93.      Repeat on any play function
  94.  
  95.      Track skip
  96.  
  97.      Music search
  98.  
  99.      Replay track
  100.  
  101.      Pause
  102.  
  103.      On screen volume control
  104.  
  105.      On screen balance control
  106.  
  107.      Disc catalogue allowing the storage of the following for each disc:
  108.                Disc name
  109.                Composer/artist
  110.                Music type
  111.                Disc reference
  112.                Individual track details
  113.  
  114.      Browse through catalogue - with word search
  115.  
  116.      On screen display of elapsed and remaining time for both the current
  117.      track and the disc.
  118.  
  119. CDPlayer from Jupiter Software                                         Page 4
  120.  
  121. B    BASIC OPERATIONS
  122.  
  123. 1    Run CDPlayer
  124.  
  125.      To load CDPlayer, simply change to the sub-directory containing the
  126.      program, by typing the following:
  127.  
  128.           X:             <Enter>
  129.           CD \CDPLAYER   <Enter>
  130.  
  131.      where X is replaced with the drive on which CDPlayer has been installed.
  132.  
  133.      Then type:
  134.  
  135.           CDPLAYER       <Enter>
  136.  
  137.      alternatively, if the directory containing CDPlayer is included in the DOS
  138.      path, you may type CDPlayer at the DOS prompt no matter where you are
  139.      within the system.  However, if you do this you must inform the program
  140.      where your disc catalogue files are stored using the command line option,
  141.      see below.
  142.  
  143.      The CDPlayer handset will be displayed and the system will interrogate the
  144.      first CD drive to see if a disc is loaded and if it is playing - if the
  145.      disc is playing, play will not be interrupted by running CDPlayer.  If a
  146.      disc is found the information relating to the disc will be loaded and the
  147.      handset will display information which is relevant to it.  If no disc is
  148.      found in the first drive, the system will show an error status in the
  149.      handset display.  This error status will disappear as soon as a disc is
  150.      inserted into the drive.  You may change the CD at any time without
  151.      reloading CDPlayer.  The program will register that you have switched
  152.      discs and load the information relevant to the new disc.
  153.  
  154.      Command Line Option (see end of manual for more options)
  155.  
  156.      If, when loading CDPlayer, the directory containing CDPlayer is the
  157.      default it is not necessary to use any command line options.  The program
  158.      will use the default directory to load your CD database.  However, if
  159.      your database files are not resident in the default directory you must
  160.      inform the program where the files reside.  This is done by using the
  161.      command line parameter "/D=".  The path holding the data files is
  162.      specified after the equals sign.  For example, if you are running
  163.      CDPlayer from the root directory C and the data files are contained in a
  164.      directory called CDPLAYER the following would be entered:
  165.  
  166.           CDPlayer /D=C:\CDPLAYER
  167.  
  168.      Whenever CDPlayer needs to access the database it will look in the
  169.      default, or specified, directory for files with the following names:
  170.  
  171.           DISCS.IX
  172.           DISCS.DAT
  173.  
  174.      If they are not found it will create these two files to store a new
  175.      database.
  176.  
  177. 2    The CD Handset
  178.  
  179.      The handset is made up of three areas:
  180.  
  181.  
  182. CDPlayer from Jupiter Software                                         Page 5
  183.  
  184.  
  185.                          Figure 1 - The CD Handset
  186.  
  187.           Display             -    showing the play mode, track being played
  188.                                    and track and disc time elapsed and
  189.                                    remaining
  190.           Play controls       -    using the numeric key pad to provide the
  191.                                    "buttons" normally available on a CD Player
  192.           Selection controls  -    using alpha keys for play mode selection and
  193.                                    catalogue functions
  194.  
  195.      To the right of the handset a scroll bar indicates the current volume
  196.      setting.  An up arrow appears at the top and a down arrow at the end,
  197.      indicating that you press these keys to increase and decrease volume.
  198.  
  199.      At the foot of the function key display a scroll bar indicates the
  200.      current balance setting.  The arrows displayed at either end indicate
  201.      that pressing these will adjust the volume balance between the speakers.
  202.      Pressing "*" will centralize the control.
  203.  
  204.      Not all drives support variable volume and on these drives the volume
  205.      will be constant if the slider is anywhere but at the bottom, or fully to
  206.      the side.  In these cases play will be muted on one or both speakers.
  207.  
  208.      A window is also displayed showing the name of the disk and the title of
  209.      the current track, as recorded in the entry for the disc in the disc
  210.      catalogue, see section C.  This window can be suppressed by including a
  211.      command line parameter of /S when running CDPlayer.
  212.  
  213. 3    Display Area
  214.  
  215.      The display area at the top of the handset, see figure 1, is made up of
  216.      four lines of information relating to the current disc being played.
  217.  
  218.      Line 1
  219.      To the left of line 1 is displayed the current mode of play, this
  220.      can be one of four modes:
  221.  
  222.           Disc           -    play the whole disc from the currently selected
  223.                               track
  224.           Track          -    play the selected track only
  225.           Shuffle Play   -    play the tracks on the disk in a random order
  226.           Custom Play    -    play the tracks listed in the custom play field
  227.                               of the disc's record.
  228.  
  229.      To the right of line 1 the word "Repeat" will be displayed if the
  230.      currently selected play mode is to be repeated, i.e.  repeat the whole
  231.      disc, the track or the custom programme.
  232.  
  233.      Line 2
  234.      To the left of line 2 will appear one of the following:
  235.  
  236.           Stop      -    this will appear if the disc inserted is not currently
  237.                          being played
  238.           Play      -    this will appear if the disc is currently being played
  239.           Pause     -    this will appear if pause has been pressed
  240.           Working   -    this will appear momentarily when one of the function
  241.                          keys has been pressed
  242.           Reading   -    this will be displayed when the player is loading
  243.                          control data from the disk.
  244.           Error     -    this will be displayed if no disc is present in the
  245.                          first drive or if the drive is open.
  246.  
  247.      The remainder of line 2 simply contains headings for the information
  248.      displayed on lines 3 and 4.
  249.  
  250.      Line 3
  251.      This line contains details of the track currently selected, or
  252.      being played, together with the playing time elapsed and that remaining
  253.      for the track.
  254.  
  255.      Line 4
  256.      This line contains details of the amount of playing time which has
  257.      elapsed and is remaining for the disc.
  258.  
  259. CDPlayer from Jupiter Software                                         Page 6
  260.  
  261. 4    Functions Keys
  262.  
  263.      The remainder of the handset, see figure 1, shows the keys which are
  264.      active when CDPlayer is running.
  265.  
  266.      The functions available are as follows:
  267.  
  268.      9/P  Play.  Pressing this key will either play the whole of the disc from
  269.           the currently selected track, the selected track only or any custom
  270.           programme, depending on the play mode (see function "T" below)
  271.  
  272.      8/I  Pause/Interrupt.  Pressing this key will cause play to pause, and
  273.           pressing the key a second time will result in play continuing.
  274.  
  275.      7/S  Stop.  Pressing this key causes play to cease.
  276.  
  277.      6/N  Next Track.  This key causes the system to move forward to the next
  278.           track on the disc based on the mode of play.
  279.  
  280.      4/L  Last Track.  This key causes the system to move back to the
  281.           previous track on the disc based on the mode of play.
  282.  
  283.      5/C  Replay Current track.  Pressing this key, when a disc is being played,
  284.           will cause the system to replay the currently selected track from
  285.           the beginning.
  286.  
  287.      3/F  Fast Forward.  Pressing this key causes the system to jump to a point
  288.           30 seconds later in the track.  This key is only effective while a CD
  289.           is being played.
  290.  
  291.      1/B  Fast Back.  Pressing this key causes the system to jump to a point
  292.           30 seconds earlier in the track.  This key is only effective while a
  293.           CD is being played.
  294.  
  295.      2/E  Eject/Close.  For drives which have an automatic eject and closing
  296.           facility, this key will either open or close the drive.  If a disc
  297.           is being played when this key is pressed, play will cease and the
  298.           disc will be ejected.
  299.  
  300.      ./G  Pressing this key causes the system to request the track number to
  301.           jump to.  If the disk is in play mode, play will continue from the
  302.           selected track.
  303.  
  304.    Arrows Adjust volume and balance.  (*=centralize balance)
  305.  
  306.      0    Exit.  Pressing this key, or "Esc", will terminate CDPlayer.  If a CD
  307.           is being played when the program is terminated, it will continue to
  308.           play.
  309.  
  310.      R    Repeat.  This key toggles repeat mode.  When repeat mode is on,
  311.           "Repeat" is displayed on line 1 of the display, the current play mode
  312.           will repeat continuously until "R" is pressed again (or stop is
  313.           pressed).
  314.  
  315.      M    Track/Custom/Shuffle/Disc.  This key circulates between the three
  316.           play modes, however, if no custom programme has been created for the
  317.           disc currently being played, it will skip past this mode.  The three
  318.           modes are as follows:
  319.  
  320. CDPlayer from Jupiter Software                                         Page 7
  321.  
  322.                Track     -    play the current track only
  323.                Custom    -    play the tracks entered in the custom play field
  324.                               of the database record for the current disc.
  325.                               Whenever a disc is inserted the program
  326.                               identifies the disc and if a record exists for
  327.                               it, it will be loaded and any custom play
  328.                               programme will be available.
  329.                Shuffle   -    shuffle the tracks into a random order for
  330.                               playing.  If repeat is on when playing a disk in
  331.                               shuffle mode, the disk will be repeated played
  332.                               with the tracks shuffled into a different order
  333.                               on each play.
  334.  
  335.                Disc      -    play the whole disc from the track currently
  336.                               selected
  337.  
  338.      D    Disc Catalogue.  Pressing this key will cause the system to enter
  339.           disc catalogue mode in one of three ways:
  340.  
  341.                1. If a record already exists for the disc inserted in the drive
  342.                the record will be loaded and offered for editing.
  343.  
  344.                2. If a record does not exist for the disc inserted in the drive
  345.                the system will load the track data from the CD and offer a
  346.                blank record for a new record to be created.
  347.  
  348.                3. If no disc is inserted in the drive, i.e. the handset is
  349.                displaying "Error", the system will enter browse mode, for
  350.                details see the next section.
  351.  
  352.    O/X/V  Import/Export/CSV.  Pressing these keys access the database import
  353.           and export facilities.
  354.  
  355.           Export data
  356.  
  357.           The information stored in the CD catalogue may be exported in one of
  358.           two formats:
  359.  
  360.           Record format       Where each field is written to the file on a
  361.                               separate line, each record occupying a fixed
  362.                               number of lines. (press X)
  363.  
  364.           CSV                 Where the whole record is written on one line in
  365.                               Comma Separated Variable format. (press V)
  366.  
  367.           In both cases the order of the record is as follows:
  368.  
  369.                     Disc ID
  370.                     Name
  371.                     Composer/artist
  372.                     Music type
  373.                     Custom play
  374.                     Disc reference
  375.                     30 track titles
  376.  
  377.           On selecting the appropriate option, you will be asked to:
  378.  
  379.                     Enter path and name of file to create
  380.  
  381.           Enter the full path and name and press <enter>.  If you select the
  382.           option but do not wish to proceed, pressing Esc will abort the
  383.           routine and return you to the handset.
  384.  
  385.           If the file already exists you will informed of this fact and asked
  386.           to confirm that you wish to proceed.
  387.  
  388.           A count of the records being exported is displayed as the file is
  389.           created and on completion a message indicating that the process was
  390.           successful.
  391.  
  392.           Import data
  393.  
  394.           Data may be imported from a file stored in Record Format, see above.
  395.           The system uses the Disc ID to identify records and if the ID
  396.           already exists in the database the record will be updated, if it
  397.           does not exist a new record will be created.  You may use this
  398.           facility to merge multiple databases.
  399.  
  400.           On selecting the import data option, you will be asked to:
  401.  
  402.                     Enter path and name of file to import
  403.  
  404.           Enter the full path and name and press <enter>.  If you select the
  405.           option but do not wish to proceed, pressing Esc will abort the
  406.           routine and return you to the handset.
  407.  
  408.           If the file does not exist, or is not in the correct format, a
  409.           message will be displayed.  If the file is acceptable, the data will
  410.           be imported and a progress message displayed.  When the import is
  411.           complete a message to this effect will be displayed.
  412.  
  413.           If any new records are added during an import they will not contain
  414.           details of track time, and the total number of tracks may not be
  415.           correct as this will be based on the track titles recorded.
  416.           However, both the track times and the total number of tracks will be
  417.           updated by the system on the first occasion that the CD is loaded
  418.           and the data record accessed.
  419.  
  420.      If you have a mouse installed you can control the handset with it.  When
  421.      the handset is displayed, the mouse cursor will be visible and you may
  422.      click on a button or the arrow keys of the volume controls to invoke the
  423.      function.  Clicking on the bar of the balance slider will centralize the
  424.      control.
  425.  
  426.  
  427. CDPlayer from Jupiter Software                                         Page 8
  428.  
  429. C    DISC CATALOGUE
  430.  
  431.      CDPlayer provides a facility for maintaining and searching a catalogue of
  432.      your CDs.  Whenever a CD is inserted in the drive, CDPlayer identifies the
  433.      disc and determines whether or not a record exists in the database.  If a
  434.      record is found it is loaded and any custom play programme is made
  435.      available for playing.  If a record is not found CDPlayer will allocate a
  436.      unique identification to the disc and determine the number of tracks and
  437.      playing time of each.  It is possible to play CDs which do not have an
  438.      entry in the database, however, the custom play facility will not be
  439.      available until a record has been created.
  440.  
  441.      1    Entering/editing the record for the current disc
  442.  
  443.           When a disc is inserted in the drive, the system displays details
  444.           regarding the disc in the handset display and you may access the
  445.           record for the CD by pressing "D" - this will operate whether or not
  446.           the current CD is being played or is in "stop mode".  On pressing
  447.           "D" the Record Screen will be displayed, see figure 2.
  448.  
  449.  
  450.                          Figure 2 - Record Screen
  451.  
  452.           If a record for the CD already exists it will be loaded and
  453.           presented to you for edit, if no record exists a blank record screen
  454.           will be displayed containing the total tracks on the disc, the
  455.           total playing time and the playing times for each track.
  456.  
  457.           Each record consists of the following:
  458.  
  459.                Disc name - up to 30 characters.  Records are sorted
  460.                alphabetically by disc name when displayed in browse mode, see
  461.                below.
  462.  
  463.                Composer/Artist - this may be up to 30 characters and can be
  464.                used to record the composer or artist.
  465.  
  466.                Music type - a field of 15 characters which you can use to
  467.                identify the type of music, e.g. baroque, romantic, pop etc.
  468.  
  469.                Custom play - this field is 30 characters long and contains the
  470.                tracks to be played when custom play mode is selected.  Tracks
  471.                are identified by a number from 1 to 9 or a letter from A to U
  472.                (representing tracks 10 to 30).  To set up a custom play simply
  473.                enter the track identifications one after the other in the
  474.                order in which they are to be played.  For example if you wish
  475.                to play track 7 followed by 10 and then 15, enter "7AF".
  476.  
  477.                Disc reference - a field of 15 characters in which you may
  478.                record the reference by which you identify the disc.  It is
  479.                sensible to allocate unique references to each of your discs as
  480.                this field is displayed when browsing through your CD
  481.                collection, providing a means of identifying the disc you are
  482.                seeking.
  483.  
  484.                Track details - you may enter a description of up to 50
  485.                characters (100 characters for registered users), shown within
  486.                a scrolling field of 25 characters if the disc contains more
  487.                than 15 tracks, for each track on the disc.  When browsing
  488.                through your CD catalogue, "word filter" searches all fields
  489.                within a record including track details, it is therefore
  490.                possible to search for
  491.  
  492.  CDPlayer from Jupiter Software                                        Page 9
  493.  
  494.                a particular track and then identify the disc on
  495.                which it resides.  See section on browsing below.
  496.  
  497.                Disc ID - Each disc record is indexed by a unique 8 digit hex
  498.                string.  This key is shown on the edit screen for reference
  499.                purposes.
  500.  
  501.           The system allows you to record details of up to 30 tracks for each
  502.           CD.  Two edit screens are provided, one for discs with 15 or less
  503.           tracks and one for those with over 15 tracks.  The edit screen for
  504.           the the former, displays the track list in a single column while
  505.           that for the latter uses a two column format.
  506.  
  507.           If the CD is playing, the track currently being played is
  508.           highlighted and the track and disc status are shown at the top right
  509.           of the Record Screen.  If the CD is being played in Shuffle mode,
  510.           the order in which the tracks are being played is displayed at the
  511.           top right of the window.
  512.  
  513.           On accessing the record, the entry field will be positioned by "Disc
  514.           name".  Enter or edit the name of the disc and press <Enter> to
  515.           move to the "Composer/Art." field.  If you enter all 30 characters
  516.           it is not necessary to press <Enter>.  You may continue entering
  517.           the fields one at a time and on completing the entry for the final
  518.           track the entry field will move back to "Disc name".
  519.  
  520.           You may move from field to field by pressing the "up" and "down"
  521.           arrow keys, provided the cursor is positioned on the first character
  522.           of the field.
  523.  
  524.           The following keys are available to you whilst entering information:
  525.  
  526.                Insert      -  inserts a space at the current cursor position
  527.  
  528.                Delete      -  deletes the character at the current cursor
  529.                               position
  530.  
  531.                Right arrow -  moves the cursor one position to the right
  532.  
  533.                Left arrow  -  moves the cursor one position to the left
  534.  
  535.                Ctrl V      -  toggles insert mode on and off.  If insert mode
  536.                               is on the cursor is displayed as a flashing
  537.                               box, if off it is a flashing line.  In insert
  538.                               mode characters are inserted within any existing
  539.                               text and the back space key is destructive.  In
  540.                               over write mode characters over write existing
  541.                               text and the back space key is non destructive.
  542.  
  543.           At any point when the Records Screen is displayed pressing "F8" will
  544.           access the browse window, see below.
  545.  
  546.           When you have finished entering or editing the record press "Esc".
  547.           If you have made any changes to the record the system will ask you
  548.           if you wish to save the edited record.  Pressing "Y" will cause the
  549.           changes to be stored in the database, while pressing "N" will
  550.           discard the changes you have made and leave the original record
  551.           intact, if one existed.
  552.  
  553.      2    Browsing through your catalogue
  554.  
  555.           Pressing "F8" when the Record Screen is displayed, or pressing "D"
  556.           when the handset is displayed and an error status is indicated,
  557.           accesses the Browse Screen.  See figure 3.
  558.  
  559.  
  560.                          Figure 3 - Browse Screen
  561.  
  562.           If you have a mouse installed, a scroll bar will appear on the right
  563.           hand side of the window and a mouse cursor will appear in the
  564.           centre of the screen.  The scroll bar indicates the relative
  565.  
  566. CDPlayer from Jupiter Software                                         Page 10
  567.           position of the highlighted record within the database and it use is
  568.           described below.
  569.  
  570.           The Browse Screen is divided into three areas as follows:
  571.  
  572.                1    Heading           - taking up the first two lines
  573.  
  574.                2    Catalogue display - showing 10 entries from the database at
  575.                                         a time
  576.  
  577.                3    Instruction area  - displayed on the last two lines
  578.  
  579.           On accessing the Browse Screen, the first ten entries in your
  580.           database, based on a alphabetical sort of the disc name, will be
  581.           displayed.  Each line contains the following:
  582.  
  583.                Disc name
  584.                Composer
  585.                Music type
  586.                Disc reference
  587.  
  588.           The first entry will be highlighted.  You may scroll through your CD
  589.           catalogue with the following keys:
  590.  
  591.           Page up   -    Pressing "Page up" will cause the list to scroll back
  592.                          10 records.
  593.  
  594.           Page down -    Pressing page down will cause the list to scroll
  595.                          forward 10 records.
  596.  
  597.           Up arrow  -    Pressing "Up arrow" moves the highlight bar to the
  598.                          previous record, scrolling the list back if necessary.
  599.  
  600.           Down arrow-    Pressing "Down arrow" moves the highlight to the
  601.                          next record, scrolling the list forward if necessary.
  602.  
  603.           Home      -    Pressing "Home" displays the first 10 entries in the
  604.                          list.
  605.  
  606.           End       -    Pressing "End" displays the last 10 entries in the
  607.                          list.
  608.  
  609.           If you have a mouse you may use it to scroll up and down a line at a
  610.           time by clicking on the "up" and "down" arrows displayed in the
  611.           instruction area.  Clicking on the "Page up" and "Page down" arrow
  612.           will cause the screen to scroll up and down ten entries at a time,
  613.           as will clicking on the arrows at the top and bottom of the scroll
  614.           bar.  You may move to the beginning of the list by clicking on
  615.           "Home" and to the end of the list by clicking on "End".
  616.  
  617.           Mouse users can also jump to a relative position within the list by
  618.           clicking on the scroll bar itself.  For example, if you click two
  619.           thirds of the way down the scroll bar the system will jump to two
  620.           thirds of the way through your catalogue.
  621.  
  622.           Goto Disc
  623.  
  624.           It is possible to jump to a specific disc, by pressing "G" and
  625.           entering the first few characters of the disc name.  If the name
  626.           entered does not exist the system will jump to the next highest name
  627.           found, based on an alphabetical sort.
  628.  
  629. CDPlayer from Jupiter Software                                         Page 11
  630.  
  631.           Word Filter
  632.  
  633.           Pressing "W" will cause the system to request the entry of a filter
  634.           string, with the prompt "Enter word filter".  The filter string can
  635.           be up to 10 characters long (30 characters for registered users)
  636.           and may be a single word or a group of words.  On entering a string
  637.           the system will redisplay the browse list containing only those
  638.           records which contain the string entered in the Composer/Artist
  639.           field,  for registered users the string may be present within any
  640.           field, and case is ignored.
  641.  
  642.           You may use the word filter to, for example, display all music by
  643.           Mozart.  For registered users, this will result in all discs being
  644.           listed which contain Mozart in any field, e.g.  as the Composer or
  645.           within track details.  It will therefore pick up any compilation
  646.           discs which include Mozart music.  Once the list is displayed you
  647.           may scroll through the filtered list in the same way as you scroll
  648.           through the full list.  Filtering is deactivated by pressing "W" for
  649.           a second time or by exiting from the Browse Window.
  650.  
  651.           Exit From Browse Mode
  652.  
  653.           You exit from the Browse Window by pressing, or clicking on, "Esc".
  654.  
  655.      3    Editing during browsing
  656.  
  657.           When browsing through your database, a record may be selected for
  658.           viewing or editing by highlighting it on the Browse Screen and
  659.           pressing <Enter>, or by double clicking on the entry.  The Edit Disc
  660.           Record Screen will be displayed, which is in the same format as the
  661.           Record Screen.  You may edit the selected record, if required, in
  662.           the same way as records are edited from the Record Screen.
  663.  
  664.           To exit from the Edit Disc Record Screen press "Esc".  If you have
  665.           edited the record you will be asked if you want it saved; pressing
  666.           "Y" will cause your catalogue to be updated while pressing "N" will
  667.           discard any changes made.
  668.  
  669.      4    Deleting a record  (Registered users only)
  670.  
  671.           If you wish to delete a record, highlight it in the Browse Window
  672.           and press "D".
  673.  
  674.           A window will be displayed asking for confirmation that you wish to
  675.           delete the record.  If you do wish to continue press "Y" and it will
  676.           be removes, otherwise press "N".
  677.  
  678.      5    Rebuilding the database index
  679.  
  680.           It is possible that your database index may become corrupt.  This is
  681.           not likely to happen very often, but loss of power to the system
  682.           while the index is being updated is one event which will definitely
  683.           corrupt the data.
  684.  
  685.           If the system detects a problem with the index it will inform you
  686.           that the index requires rebuilding and ask you to confirm that you
  687.           wish this to be done.
  688.  
  689.  
  690.  
  691. CDPlayer from Jupiter Software                                         Page 12
  692.  
  693. D    INSTALLATION
  694.  
  695.      An automated installation routine is provided on the disk.  To run this
  696.      routine insert the disk in your floppy drive, log on to the drive and run
  697.      the installation routine by typing:
  698.  
  699.           X:             <Enter>
  700.           INSTALL Y      <Enter>
  701.  
  702.      Where "X" will either by "A" or "B" depending on the drive being used and
  703.      "Y" will be the letter identifying the hard disk on which CDPlayer is to
  704.      be installed.
  705.  
  706.      The installation routine will create a directory called CDPLAYER within
  707.      the root of your hard disk, and copy the programs to it.  It is, in
  708.      fact, only necessary to have the program file CDPLAYER.EXE present on the
  709.      hard disk and this can be resident in any directory.
  710.  
  711.      When the program is first run, it will create the database files
  712.      required to store your CD catalogue, see section B.1.  for more
  713.      information.
  714.  
  715.      To update a shareware installation, simply copy CDPLAYER.EXE from the
  716.      issue disk to the directory containing your shareware version of the
  717.      program.
  718.  
  719. Note - ADDITIONAL COMMAND LINE OPTIONS
  720.  
  721.      Five new command line options are available.  These allow you to change
  722.      the screen colours used to display the handset and database.  They are as
  723.      follows:
  724.  
  725.           /S     - Suppress display of disk title and current track
  726.  
  727.           /N=999 - Normal display used for handset display area
  728.           /E=999 - Display of entry keys
  729.           /B=999 - Display of background
  730.           /V=999 - Display of view/browse screen
  731.  
  732.      The may appear in any order and must be separated by at least one space.
  733.      999 = The number of the attribute to be used from 0 to 255, following
  734.      standard IBM colours.
  735.  
  736. E. MEMORY RESIDENT PLAYER
  737.  
  738. This disk included a restricted demonstration copy of CDTsr(TM).  Note this
  739. is not a shareware program but all registered users of CDPlayer will also
  740. receive a full unrestricted copy of this program.
  741.  
  742. CDTsr is a memory resident CD playing handset which can be called up over
  743. any text based application.  The default key sequence for invoking help is
  744. <Alt><P>, however this may be changed and a second key sequence may be
  745. defined using command line parameters.
  746.  
  747. CDTsr is a swapping memory resident program, so when not in use it occupies
  748. less than 7kb of memory.  On being called, the system will secure the DOS
  749. environment before loading itself and displaying the handset.  On exit, the
  750. operating system environment is reinstated and the user may continue.  By
  751. adopting this approach the system occupies the minimum possible memory and can
  752. be used with programmes that require large amounts of memory to be available
  753. to them.
  754.  
  755. This program allows DOS users to pop up a CD handset similar to that contained
  756. in CDPlayer.  This is very handy for pausing the CD to take a phone call,
  757. carrying on with your current application and then resuming play by popping up
  758. the handset a second time.  Also for playing a new CD without having to close
  759. down your current application.
  760.  
  761. To load CDTsr simply change to the directory containing CDTsr and type:
  762.  
  763.           CDTSR             <Enter>
  764.  
  765. CDTsr will be loaded and a welcome message displayed but the program will
  766. remain dormant.  You may now activate CDTsr at any time, either from the DOS
  767. line or from within an application, by pressing <Alt><P>.
  768.  
  769. The following command line parameters are available and should be inserted
  770. after the name of the program, separated by spaces.  The order of the
  771. appearance of the command line parameters has no effect.
  772.  
  773. a) \bold /U - Unload
  774.  
  775. Inserting this command line parameter, which must appear on its own, causes
  776. CDTsr to remove itself from memory providing it is safe so to do.  If it
  777. is not safe for CDTsr to be removed, because other programmes have been
  778. loaded after it, CDTsr will display a message indicating that it is not
  779. safe to unload itself and will remain in memory.  If CDTsr is successfully
  780. unloaded, you will be informed of this fact before being returned to the DOS
  781. prompt.
  782.  
  783. b) /S - Swap File
  784.  
  785. The program maintains two swap files on disk that are used to temporarily hold
  786. the DOS environment when the handset is being used.  These swap files default to:
  787.  
  788.         CDSwp.1$$
  789.         CDSwp.2$$
  790.  
  791. and are stored in the root of drive C.  If you wish to change name of the file
  792. used, or the directory where the swap file is stored, use the /S parameter in
  793. the following format:
  794.  
  795.         /S= X:\path\name
  796.  
  797. without providing an extension.  The swap file will then be created using the
  798. name provided and extensions of ".1$$" and ".2$$".  If the path specified
  799. cannot be found a message will be displayed indicating that CDTsr cannot be
  800. loaded.
  801.  
  802. Important Warning for Network Users
  803.  
  804. Where CDTsr is being used over a network and the swap files are being
  805. stored on the file server, it is essential that each user's swap files are
  806. contained in a different directory on the disk, or carry different names.
  807. This can easily be achieved by using the users home directory.  If this is not
  808. done crashes will occur as the users DOS environment, which has been stored to
  809. the swap file, may be overridden by the DOS environment stored by another user
  810. and hence will not be available to be reloaded by the first user when the
  811. handset closed.
  812.  
  813. c) /M - No Swap Message
  814.  
  815. By default CDTsr displays a message indicating that it is swapping in and
  816. swapping out as these actions occur.  If you have EMS available, CDTsr
  817. will swap to EMS rather than to disk and these messages may be annoying as the
  818. speed of swapping will be virtually instantaneous.  You may therefore turn off
  819. the swap message by including this command line parameter.
  820.  
  821. d) /F - Force use of disk for swapping
  822.  
  823. By default the system will swap to EMS if it is available.  When memory is at
  824. a premium you may want to keep all EMS available for your applications, adding
  825. /F on the command line forces the system to create the swap files on disk.
  826.  
  827. e) Display Attributes
  828.  
  829. As for CDPlayer --- /N, /E and /B.
  830.  
  831. f) /P -  2nd Hot Key
  832.  
  833. The standard key sequence of <Alt><P> is always available for calling the
  834. handset.  However, it may be that you would like to use an alternative key
  835. sequence.  You can select an alternative key sequence by using the P
  836. parameter, which takes the following format:
  837.  
  838.         CDTSR /P=\$0000
  839.  
  840. The four zero's are made up of two pairs of hexadecimal numbers and are
  841. interpreted as follows:
  842.  
  843. First two digits
  844.  
  845. These are made up from the following and represent the status of the Shift,
  846. Alt and Ctrl keys:
  847.  
  848.         00      no shifts
  849.         01      right shift
  850.         02      left shift
  851.         04      Ctrl
  852.         08      Alt
  853.  
  854. If you wish to use more than one key in combination, add together the codes
  855. given.  For example, <Ctrl><Alt> is "0C".
  856.  
  857. Second two digits
  858.  
  859. The second two zeros must represent a valid scan code, in hexadecimal.  The
  860. following table sets out the valid scan codes:
  861.  
  862.                    A-1E    N-31     0-0B    F1-3B      [-1A
  863.                    B-30    0-18     1-02    F2-3C      ;-27
  864.                    C-2E    P-19     2-03    F3-3D      ,-33
  865.                    D-20    Q-10     3-04    F4-3E      /-35
  866.                    E-12    R-13     4-05    F5-3F      \-2B
  867.                    F-21    S-1F     5-06    F6-40      ]-1B
  868.                    G-22    T-14     6-07    F7-41      '-28
  869.                    H-23    U-16     7-08    F8-42      .-34
  870.                    I-17    V-2F     8-09    F9-43      '-29
  871.                    J-24    W-11     9-0A    F10-44
  872.                    K-25    X-2D             F11-57
  873.                    L-26    Y-15             F12-58
  874.                    M-32    Z-2C
  875.  
  876.     For example:
  877.  
  878.         /P=$0244        identifies left shift + F10
  879.         /P=$082E        identifies Alt + C
  880.         /P=$0517        identifies Ctrl + right shift + I
  881.  
  882. As the alternative key sequences.
  883.  
  884. g) /R - Replace main Hot Key
  885.  
  886. The standard Hot Key of <Alt><P> can be replaced using this parameter.  It is
  887. used in exactly the same way as "/P" but the defined key sequence will be
  888. available in place of the default not in addition to it.  You may use both
  889. "/P" and "/R" together, selecting two sequences of your choosing.
  890.  
  891. h) /K - Keep in memory
  892.  
  893. By default the program only keeps a small portion in memory when it is not in
  894. use.  It will swap in the remaining code when called and swap it out when
  895. closed.  By this method only 6.5k of memory is used by CDTsr.  If you wish to
  896. force the program to remain in memory and not swap to disk, add the command
  897. line parameter /K.  If this is used the system will take up approximately
  898. 86.5k of memory.
  899.  
  900.  
  901.  
  902.  
  903. The handset is very similar to that contained in CDPlayer, but it does not
  904. provide access to your disc catalogue, and the play mode cannot be changed.
  905. All the functions provided by pressing the numeric keys, described in section
  906. B.4., are available and will remain in force when you exit from the program.
  907. The program will also remember the status of the drive.  It is therefore
  908. possible to call up the handset, pause a CD, close the handset and continue
  909. work and then call it again to continue play from the same point on the disk
  910. --- very handy when taking phone calls.
  911.